home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 002 / pco108.arc / README.2 < prev    next >
Text File  |  1986-02-21  |  8KB  |  194 lines
  1. These 8 utility programs are included merely for your convenience.  They are
  2. not connected in any way with PC-OUTLINE.  They were written by the
  3. developers of PC-OUTLINE for their own convenience and are shared with you
  4. in hopes that they will likewise make your life a little easier.  Who said
  5. you never get SOMETHING for NOTHING?
  6.  
  7.  
  8.                        6 UTILITY PROGRAMS
  9.                        ==================
  10.  
  11.  
  12. 1)  GLOBAL.COM - for doing any dos function on an entire directory
  13.                  tree at once.  Useful for finding lost files or deleting
  14.                  all .BAK files, etc. across many directory boundaries.
  15.  
  16. 2)  CPY.COM    - for backing up a series of files to floppy.  You can list
  17.                  the files to be backed up in a separate file and CPY will
  18.                  automatically prompt you on when to insert a new disk.
  19.  
  20. 3)  DIRS.COM   - gives the total disk space occupied by a set of files.
  21.                  Useful for seeing how much disk space a bunch of files
  22.                  are taking up.  For example, "DIRS *.wks" would tell you
  23.                  how much space all of your .wks files in the current
  24.                  directory occupy.
  25.  
  26. 4)  MOVE.COM   - Allows you to actually move a file from one directory to
  27.                  another without an intermediate copy.
  28.  
  29. 5)  MEM.COM    - Shows the amount of free memory without waiting for a time
  30.                  consuming CHKDSK.
  31.  
  32. 6)  BEEP.COM   - Generates a beep.  Useful for batch files to indicate errors
  33.                  or completion.
  34.  
  35. 7)  PUSHDIR.COM- Saves the current directory from a batch file.
  36.  
  37. 8)  POPDIR.COM - Restores the current directory from the previous
  38.                  PUSHDIR.
  39.  
  40. ===============================================================================
  41. ===============================================================================
  42.  
  43.                        DETAILED DESCRIPTIONS:
  44.  
  45. GLOBAL.COM
  46. ----------
  47.  
  48. USAGE:    GLOBAL <any dos command or executable program>
  49.  
  50. Global executes any dos command or program on an entire directory tree.
  51.  
  52. For example, if you log to the root directory and execute "GLOBAL DIR" then
  53. you will see a directory listing of every directory and sub-directory on
  54. your hard disk.
  55.  
  56. If you execute "GLOBAL DIR PLAY.DOC", then you will find all occurences of
  57. PLAY.DOC on your hard disk.
  58.  
  59. You can even use non-dos commands like "GLOBAL DIRS *.WKS" would show you the
  60. total disk space occupied by all .wks files in each directory on your hard
  61. disk.
  62.  
  63. Global.com starts from the current directory and goes down the directory tree.
  64. To cover the whole disk, start in the root directory.  To just cover part of the
  65. hard disk, start in a sub-directory.
  66.  
  67. ===============================================================================
  68.  
  69. CPY.COM
  70. -------
  71.  
  72. USAGE #1:    CPY <same dos parameters as the COPY command> OR
  73. USAGE #2     CPY @<filename> destination path
  74.  
  75. USAGE #1:
  76.  
  77. CPY can be a direct replacement for the copy command in dos with the added
  78. benefit that it will not quit when a floppy fills up.  Instead it will,
  79. stop, erase the partial file, prompt you for a new floppy and continue on
  80. its way.
  81.  
  82. For example:  "CPY c:\*.wks a:" would copy all .wks files in the root
  83. directory of c: to a:.  If the floppy in drive a: filled up during the copy,
  84. the partially copied file would be erased from the destination floppy and
  85. you would be prompted for a new floppy.
  86.  
  87. USAGE #2:
  88.  
  89. This usage of the CPY commmand allows you to specify a series of filenames
  90. to be copied to the same location.  Simply create an ascii file (let's use
  91. a file named CPYFILES for the sake of this example) with each file to be copied
  92. listed, one per line (wildcards are allowed).  Then to copy all of those files
  93. to a new location simply type "CPY CPYFILES A:" and one by one all the files
  94. listed in the CPYFILES will be copied to a:.  Again, if the floppy fills up
  95. you will be prompted to insert a new one.
  96.  
  97. The can be extremely useful for backing up to floppy a standard set of files
  98. that doesn't easily conform to a simple dos wildcard.
  99.  
  100. ===============================================================================
  101.  
  102. DIRS.COM
  103. --------
  104.  
  105. USAGE:    DIRS <any dos path/filename>       (wildcards permitted)
  106.  
  107. DIRS works just like DIR except instead of displaying each of the files, it
  108. simply adds the sizes of all of the files that would have been displayed
  109. had it been the DIR command.  DIRS uses the space actually occupied on the
  110. disk, not just the listed file size in the DIR listing.  NOTE:  hard disk
  111. space is allocated in 4k increments on the XT so that a file that shows up
  112. as 7 bytes like BEEP.COM actually takes up 4k on the hard disk.  DIRS takes
  113. this into account.
  114.  
  115. For example "DIRS *.WKS" would show you how much space all your .wks files were
  116. occupying.  Or  "DIRS *.BAK" would show you how much space would be freed if
  117. you erased all the .BAK files.
  118.  
  119. ===============================================================================
  120.  
  121. MOVE.COM
  122. --------
  123.  
  124. USAGE:     MOVE <source path/filename> <destination path/filename>
  125.  
  126. MOVE will move a file from one directory to another without making an
  127. intermediate copy.  The two names must be on the same disk drive.
  128.  
  129. For example, "MOVE C:\PLAY\TEMP C:\TEST" will move the file c:\play\temp to
  130. a new location and name c:\test.
  131.  
  132. ===============================================================================
  133.  
  134. MEM.COM
  135. -------
  136.  
  137. USAGE:    MEM
  138.  
  139. MEM lists the amount of free memory in your computer as reported by dos
  140. without having to wait for the painstakingly slow CHKDSK command.
  141.  
  142. ===============================================================================
  143.  
  144. BEEP.COM
  145. --------
  146.  
  147. USAGE:    BEEP
  148.  
  149. BEEP makes a beeping noise on the speaker.  This can be very useful in batch
  150. files to indicate either an error condition or completion of some long task.
  151.  
  152. ===============================================================================
  153.  
  154. PUSHDIR.COM
  155. -----------
  156.  
  157. USAGE:    PUSHDIR <optional pathname>
  158.  
  159. PUSHDIR allows you to save the current directory from a batch file, switch to
  160. another current directory and switch back to the original later in the batch
  161. file (by using its companion POPDIR).  For example, if 123 was located in a
  162. directory called c:\123, then you could create a batch file like the following:
  163.  
  164. PUSHDIR C:\123
  165. 123
  166. POPDIR
  167.  
  168. Assuming you had pathed to the batch file, you could then start 123 from
  169. anywhere on you hard disk and when you left 123, your current directory would
  170. automatically be restored as if you never left it.  Note that this is different
  171. than just pathing to 123 because 123 (like many other programs) needs the
  172. current directory to be set properly so that it can find its support files
  173. (configuration files and drivers).
  174.  
  175. The first time you use PUSHDIR a small piece of it will remain resident (about
  176. 400 bytes).  This is the storage area used to save the current directory.
  177. Subsequent PUSHDIR's and POPDIR's do not use any more memory.
  178.  
  179. PUSHDIR's and POPDIR's can be nested up to 6 levels deep.  Each PUSHDIR will
  180. save the latest current directory and each POPDIR will restore the last one
  181. saved.
  182.  
  183. ===============================================================================
  184.  
  185. POPDIR.COM
  186. ----------
  187.  
  188. USAGE:    POPDIR
  189.  
  190. POPDIR is just the counterpart to PUSHDIR.  After a PUSHDIR, POPDIR will
  191. restore the previous current directory.  See the documentation on PUSHDIR for
  192. more information.  Note:  POPDIR is of absolutely no use without first doing a
  193. PUSHDIR.
  194.